Framework de Programação C51 — Ambiente Oficial DWIN
======================================================

Este pacote reúne o material oficial da DWIN para quem vai programar em
C51 (linguagem C para o núcleo 8051) os módulos TFT da AGT Displays,
usando o Keil µVision.

Observação importante: o Keil µVision é um software pago da fabricante
Arm/Keil. Para compilar os projetos aqui dentro, é necessária uma
licença válida do Keil C51. Se você procura uma alternativa gratuita,
fale com o seu contato na AGT sobre a opção baseada em SDCC.

O que tem em cada pasta
------------------------

01 - Starter Demo - IO Pins (Keil + DGUS)
    O ponto de partida, em duas metades que trabalham juntas:
      - "Firmware (Keil)": projeto C51 mínimo e funcional para o chip
        T5L, que pisca um LED e lê o estado de uma tecla física.
      - "Screen Project (DGUS)": o projeto de tela correspondente
        (título "IO Pins"), com um ícone de interruptor que muda de
        vermelho para verde.
    As duas metades formam uma única demonstração: grave o firmware no
    chip E carregue o projeto de tela no módulo. Ao pressionar a tecla
    física, o interruptor na tela acompanha o estado do LED. Comece por
    aqui para entender a estrutura básica antes de partir para os
    exemplos mais completos abaixo.

02 - Example - Protocol 8283 (all UARTs)
    Um exemplo completo e funcional: implementação do protocolo 8283
    para as portas seriais UART2, UART4 e UART5. Bom ponto de partida
    se o seu projeto precisa de comunicação serial completa.
    O arquivo CHANGELOG.txt registra o histórico de versões.

03 - Reference Docs
    Documentação oficial da DWIN em PDF (guia de desenvolvimento do
    ASIC T5L e guia de aplicação do DGUS II), além dos arquivos de
    cabeçalho (.h) com a definição dos registradores do chip. Consulte
    aqui sempre que precisar entender um registrador ou uma função do
    sistema. O arquivo "Official DWIN Links.txt" tem links diretos
    para o fórum oficial da DWIN, caso precise de versões mais
    recentes.

04 - Evaluation Board (EK043)
    Arquivos da placa de avaliação EK043: esquemático da placa (PCB),
    datasheet e um firmware de demonstração. Útil se você estiver
    usando essa placa específica para testes.

05 - Example - TEST-C (PT1000 sensor demo)
    Outro exemplo funcional, menor: leitura de um sensor de
    temperatura PT1000.

06 - Drivers
    Drivers necessários para o ambiente de desenvolvimento funcionar:
    o driver USB do adaptador HME05, o driver AGDI do Keil (necessário
    para depuração/debug do chip T5), e o driver USB do XR21x141x
    (usado na comunicação serial via USB).
    Instale-os antes de tentar gravar ou depurar um projeto.

07 - Kernel Binaries (reference)
    Binários de referência do kernel/OS do T5L. Não são necessários
    para programar em C51, mas ficam aqui como referência.

08 - Tools
    O DownLoadFor8051, ferramenta usada para converter o arquivo
    compilado (.hex) no formato .bin que o módulo DWIN lê a partir do
    cartão SD.

Primeiros passos
-----------------

1. Instale o Keil µVision com suporte a C51 (licença própria
   necessária) e os drivers da pasta "06 - Drivers".
2. Abra o projeto em
   "01 - Starter Demo - IO Pins (Keil + DGUS)\Firmware (Keil)\USER\template.uvproj"
   pelo Keil µVision.
3. Compile o projeto (Build).
4. Dentro da pasta OBJ gerada pelo Keil, rode o script
   "01 - Starter Demo - IO Pins (Keil + DGUS)\Firmware (Keil)\build-tools\convert-hex-to-bin.bat"
   para gerar o arquivo .bin (edite a letra do drive dentro do
   arquivo .bat para apontar para o seu cartão SD).
5. Copie o .bin gerado para a pasta DWIN_SET do cartão SD, insira no
   módulo e ligue a energia para gravar.
6. Carregue a pasta "Screen Project (DGUS)" no módulo pelo software
   DGUS, do mesmo jeito que qualquer outro projeto de tela.
7. Pressione a tecla física ligada ao módulo — o interruptor na tela
   deve acompanhar o estado do LED.

Dúvidas? Fale com o seu contato na AGT Displays.
